home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / newtzset.0 < prev    next >
Text File  |  1996-09-02  |  9KB  |  199 lines
  1.  
  2.  
  3.  
  4. NEWTZSET(3)                                           NEWTZSET(3)
  5.  
  6.  
  7. NNAAMMEE
  8.        tzset - initialize time conversion information
  9.  
  10. SSYYNNOOPPSSIISS
  11.        vvooiidd ttzzsseett(())
  12.  
  13.        cccc ...... --llzz
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.        _T_z_s_e_t uses the value of the environment variable TTZZ to set
  17.        time conversion information used by _l_o_c_a_l_t_i_m_e.  If TTZZ does
  18.        not appear in the environment, the best available approxi-
  19.        mation to local wall  clock  time,  as  specified  by  the
  20.        _t_z_f_i_l_e(5)-format file llooccaallttiimmee in the system time conver-
  21.        sion information directory, is used by _l_o_c_a_l_t_i_m_e.   If  TTZZ
  22.        appears in the environment but its value is a null string,
  23.        Coordinated Universal Time (UTC)  is  used  (without  leap
  24.        second  correction).  If TTZZ appears in the environment and
  25.        its value is not a null string:
  26.  
  27.               if the value begins with a colon, it is used  as  a
  28.               pathname of a file from which to read the time con-
  29.               version information;
  30.  
  31.               if the value does not begin with  a  colon,  it  is
  32.               first  used as the pathname of a file from which to
  33.               read the time conversion information, and, if  that
  34.               file cannot be read, is used directly as a specifi-
  35.               cation of the time conversion information.
  36.  
  37.        When TTZZ is used as a pathname, if it begins with a  slash,
  38.        it  is used as an absolute pathname; otherwise, it is used
  39.        as a pathname relative to a system time conversion  infor-
  40.        mation  directory.   The file must be in the format speci-
  41.        fied in _t_z_f_i_l_e(5).
  42.  
  43.        When TTZZ is used directly as a specification  of  the  time
  44.        conversion  information, it must have the following syntax
  45.        (spaces inserted for clarity):
  46.  
  47.               _s_t_d_o_f_f_s_e_t[_d_s_t[_o_f_f_s_e_t][,,_r_u_l_e]]
  48.  
  49.        Where:
  50.  
  51.               _s_t_d and _d_s_t    Three or more  bytes  that  are  the
  52.                              designation  for  the standard (_s_t_d)
  53.                              or summer (_d_s_t) time zone.  Only _s_t_d
  54.                              is required; if _d_s_t is missing, then
  55.                              summer time does not apply  in  this
  56.                              locale.   Upper-  and lowercase let-
  57.                              ters are  explicitly  allowed.   Any
  58.                              characters  except  a  leading colon
  59.                              (::), digits, comma (,,),  minus  (--),
  60.                              plus (++), and ASCII NUL are allowed.
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. NEWTZSET(3)                                           NEWTZSET(3)
  71.  
  72.  
  73.               _o_f_f_s_e_t         Indicates the value one must add  to
  74.                              the  local time to arrive at Coordi-
  75.                              nated Universal  Time.   The  _o_f_f_s_e_t
  76.                              has the form:
  77.  
  78.                                     _h_h[::_m_m[::_s_s]]
  79.  
  80.                              The  minutes  (_m_m)  and seconds (_s_s)
  81.                              are  optional.   The  hour  (_h_h)  is
  82.                              required  and may be a single digit.
  83.                              The   _o_f_f_s_e_t   following   _s_t_d    is
  84.                              required.  If no _o_f_f_s_e_t follows _d_s_t,
  85.                              summer time is  assumed  to  be  one
  86.                              hour ahead of standard time.  One or
  87.                              more digits may be used;  the  value
  88.                              is  always  interpreted as a decimal
  89.                              number.  The hour  must  be  between
  90.                              zero  and  24,  and the minutes (and
  91.                              seconds) -- if  present  --  between
  92.                              zero  and  59.   If  preceded  by  a
  93.                              ``--'', the time zone shall  be  east
  94.                              of  the Prime Meridian; otherwise it
  95.                              shall be west (which  may  be  indi-
  96.                              cated   by   an  optional  preceding
  97.                              ``++'').
  98.  
  99.               _r_u_l_e           Indicates when to change to and back
  100.                              from  summer time.  The _r_u_l_e has the
  101.                              form:
  102.  
  103.                                     _d_a_t_e//_t_i_m_e,,_d_a_t_e//_t_i_m_e
  104.  
  105.                              where the first _d_a_t_e describes  when
  106.                              the  change  from standard to summer
  107.                              time  occurs  and  the  second  _d_a_t_e
  108.                              describes  when the change back hap-
  109.                              pens.   Each  _t_i_m_e  field  describes
  110.                              when,  in  current  local  time, the
  111.                              change to the other time is made.
  112.  
  113.                              The format of _d_a_t_e  is  one  of  the
  114.                              following:
  115.  
  116.                              JJ_n        The     Julian    day    _n
  117.                                        (1 <= _n <= 365).      Leap
  118.                                        days are not counted; that
  119.                                        is,  in   all   years   --
  120.                                        including  leap  years  --
  121.                                        February 28 is day 59  and
  122.                                        March  1 is day 60.  It is
  123.                                        impossible  to  explicitly
  124.                                        refer  to  the  occasional
  125.                                        February 29.
  126.  
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. NEWTZSET(3)                                           NEWTZSET(3)
  137.  
  138.  
  139.                              _n         The zero-based Julian  day
  140.                                        (0 <= _n <= 365).      Leap
  141.                                        days are counted,  and  it
  142.                                        is  possible  to  refer to
  143.                                        February 29.
  144.  
  145.                              MM_m.._n.._d    The _d_'th day (0 <= _d <= 6)
  146.                                        of  week  _n  of month _m of
  147.                                        the   year   (1 <= _n <= 5,
  148.                                        1 <= _m <= 12, where week 5
  149.                                        means ``the last _d day  in
  150.                                        month  _m'' which may occur
  151.                                        in either  the  fourth  or
  152.                                        the  fifth  week).  Week 1
  153.                                        is the first week in which
  154.                                        the  _d_'th day occurs.  Day
  155.                                        zero is Sunday.
  156.  
  157.                              The _t_i_m_e has the same format as _o_f_f_-
  158.                              _s_e_t  except  that  no  leading  sign
  159.                              (``--'' or ``++'')  is  allowed.   The
  160.                              default,  if  _t_i_m_e  is not given, is
  161.                              0022::0000::0000.
  162.  
  163.        If no _r_u_l_e is present in TTZZ, the rules  specified  by  the
  164.        _t_z_f_i_l_e(5)-format  file  ppoossiixxrruulleess in the system time con-
  165.        version information directory are used, with the  standard
  166.        and  summer time offsets from UTC replaced by those speci-
  167.        fied by the _o_f_f_s_e_t values in TTZZ.
  168.  
  169.        For compatibility with System V Release 3.1,  a  semicolon
  170.        (;;)  may be used to separate the _r_u_l_e from the rest of the
  171.        specification.
  172.  
  173.        If  the  TTZZ  environment  variable  does  not  specify   a
  174.        _t_z_f_i_l_e(5)-format  and  cannot  be  interpreted as a direct
  175.        specification, UTC is used.
  176.  
  177. FFIILLEESS
  178.        /usr/local/etc/zoneinfo             time zone  information
  179.        directory
  180.        /usr/local/etc/zoneinfo/localtime   local time zone file
  181.        /usr/local/etc/zoneinfo/posixrules  used  with POSIX-style
  182.        TZ's
  183.        /usr/local/etc/zoneinfo/GMT         for UTC leap seconds
  184.  
  185.        If //uussrr//llooccaall//eettcc//zzoonneeiinnffoo//GGMMTT is absent, UTC leap seconds
  186.        are loaded from //uussrr//llooccaall//eettcc//zzoonneeiinnffoo//ppoossiixxrruulleess.
  187.  
  188. SSEEEE AALLSSOO
  189.        getenv(3), newctime(3), newstrftime(3), time(2), tzfile(5)
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                                                                 3
  197.  
  198.  
  199.